package com.dms.modules.product.service;

import java.util.Map;
import java.util.List;

/**
 * 商品分析服务接口
 */
public interface ProductAnalyticsService {
    
    /**
     * 获取商品分析数据
     * @param productId 商品ID
     * @return 分析数据
     */
    Map<String, Object> getProductAnalytics(Long productId);
    
    /**
     * 获取商品转化率
     * @param productId 商品ID
     * @return 转化率数据
     */
    Map<String, Object> getProductConversionRate(Long productId);
    
    /**
     * 获取热门商品排行
     * @param limit 返回数量
     * @return 热门商品数据
     */
    Map<String, Object> getHotProductsRanking(Integer limit);
    
    /**
     * 获取商品销售趋势
     * @param productId 商品ID
     * @param days 天数
     * @return 销售趋势数据
     */
    Map<String, Object> getProductSalesTrend(Long productId, Integer days);
    
    /**
     * 获取商品用户行为分析
     * @param productId 商品ID
     * @return 用户行为数据
     */
    Map<String, Object> getProductUserBehavior(Long productId);
    
    /**
     * 获取商品分类分析
     * @param categoryId 分类ID
     * @return 分类分析数据
     */
    Map<String, Object> getCategoryAnalytics(Long categoryId);
    
    /**
     * 获取商品搜索热度排行
     * @param limit 返回数量
     * @return 搜索热度数据
     */
    Map<String, Object> getSearchHotRanking(Integer limit);
    
    /**
     * 获取商品推荐效果分析
     * @param productId 商品ID
     * @return 推荐效果数据
     */
    Map<String, Object> getRecommendationEffectiveness(Long productId);
} 